Add docker by moisesPompilio · Pull Request #71 · lightningdevkit/ldk-server

moisesPompilio · 2025-10-17T20:02:33Z

Adds Docker support for building and testing LDK Server. Includes a multi-stage Dockerfile for optimized builds and a docker-compose.yml for a full testing environment with Bitcoin Core, CLN, and LND.

Dockerfile: Multi-stage build with builder stage for Rust compilation (supports BUILD_FEATURES) and final stage for runtime. Exposes ports 3000 and 3001 for REST and Lightning connectivity.
docker-compose.yml: Sets up a complete testing environment with Bitcoin Core in regtest mode, CLN (Core Lightning), and LND for Lightning Network interactions.

- Default profile: Runs Bitcoin Core, CLN, LND (docker compose up).
- ldk-server profile: Runs Bitcoin Core, CLN, LND, LDK Server (docker compose --profile ldk-server up).
- rabbitmq profile: Runs Bitcoin Core, CLN, LND, RabbitMQ (docker compose --profile rabbitmq up).

this pr depends on #69

ldk-reviews-bot · 2025-10-17T20:02:37Z

👋 Thanks for assigning @tnull as a reviewer!
I'll wait for their review and will help manage the review process.
Once they submit their review, I'll check if a second reviewer would be helpful.

ldk-reviews-bot · 2025-10-20T00:00:30Z

🔔 1st Reminder

Hey @wpaulino! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

ldk-reviews-bot · 2025-10-23T15:34:47Z

🔔 1st Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

ldk-reviews-bot · 2025-10-25T15:35:32Z

🔔 2nd Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

ldk-reviews-bot · 2025-10-27T15:36:18Z

🔔 3rd Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

ldk-reviews-bot · 2025-10-29T15:37:06Z

🔔 4th Reminder

Hey @tnull! This PR has been waiting for your review.
Please take a look when you have a chance. If you're unable to review, please let us know so we can find another reviewer.

tnull

Thank you! Pretty much looks good to me!

One minor nit: please rewrite your commit messages to wrap at 72 characters. In general, feel free to consult https://cbea.ms/git-commit/ for guidance on how to write good commit messages.

ldk-server/ldk-server-config.toml

tnull · 2025-10-30T10:41:30Z

docker-compose.yml

+
+  bitcoin:
+    container_name: ldk-server-bitcoin
+    image: blockstream/bitcoind:29.1@sha256:9fcffa83feed0fc382dfb2f26990ca07656d150ba49434096a5aeedac6695a01


Would be cool to go for v30 directly here, just pinged somebody from Blockstream to check if they intend to upgrade the Docker image soon.

Sounds good, let’s wait for their feedback then.

And there it is: https://hub.docker.com/r/blockstream/bitcoind

Please update!

docker-compose.yml

tnull

LGTM, I think.

Happy to land this as soon as #69 lands.

benthecarman · 2025-11-02T10:21:45Z

docker-compose.yml

+      args:
+        BUILD_FEATURES: ""
+    command: [
+      "--node-listening-address=0.0.0.0:3001",


seems weird for ldk-server we use the non-default 3001 but give the default 9735 to lnd

LND uses port 9735, and LDK uses port 3001. I checked in my tests, and LDK is indeed using 3001.

benthecarman · 2025-11-02T10:23:53Z

Dockerfile

+COPY --from=builder  /opt/app/ldk-server/ldk-server-config.toml /usr/local/bin/ldk-server-config.toml
+RUN chmod +x /usr/local/bin/ldk-server
+
+EXPOSE 3000 3001


should expose 9735

This port will conflict with LND.

the dockerfile doesn't contain lnd, only ldk-server

Yeah, but the docker-compose contains LND.

The docker-compose here will just be an example regtest lightning network people will set up for testing, but the Dockerfile is actually how people will deploy production nodes so we should be optimizing for that.

benthecarman · 2025-11-02T19:34:02Z

Dockerfile

+
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+ENV PATH="/root/.cargo/bin:${PATH}"
+RUN rustup default 1.90.0


why use a debian container if you're just going to install rustup into it? why not just use the rust container

Makes sense, I replaced Debian with Rustup instead.

benthecarman · 2025-11-02T19:34:46Z

Dockerfile

+COPY --from=builder /opt/app/target/release/ldk-server /usr/local/bin/ldk-server
+COPY --from=builder /opt/app/target/release/ldk-server-cli /usr/local/bin/ldk-server-cli
+COPY --from=builder  /opt/app/ldk-server/ldk-server-config.toml /usr/local/bin/ldk-server-config.toml
+RUN chmod +x /usr/local/bin/ldk-server


is this needed? if it is should chmod the cli too

This is not needed, I removed it.

Implements multi-stage build to produce a small final image by discarding build dependencies. Supports optional BUILD_FEATURES for additional features, with cached compilation in builder stage.

introduces docker-compose.yml with Bitcoin Core, CLN, and LND for Lightning testing. The default profile runs these services; the 'ldk-server' profile adds the LDK server; the 'rabbitmq' profile includes RabbitMQ for events.

moisesPompilio · 2025-11-12T20:09:53Z

Sorry for the delay, I’m still attending Bitcoin events.

moisesPompilio · 2026-01-06T21:58:50Z

I'm closing this PR because I don't have much time to continue it.

ldk-reviews-bot requested a review from wpaulino October 17, 2025 20:12

moisesPompilio force-pushed the add-docker branch from 5d4ec81 to 61851cb Compare October 17, 2025 20:28

tnull requested review from tnull and removed request for wpaulino October 21, 2025 15:33

tnull reviewed Oct 30, 2025

View reviewed changes

moisesPompilio force-pushed the add-docker branch from 61851cb to ccdefcd Compare October 30, 2025 20:04

tnull reviewed Oct 31, 2025

View reviewed changes

moisesPompilio force-pushed the add-docker branch from ccdefcd to d573de7 Compare November 1, 2025 01:52

benthecarman reviewed Nov 2, 2025

View reviewed changes

moisesPompilio added 2 commits November 12, 2025 16:35

add Dockerfile for building with configurable features

c348d05

Implements multi-stage build to produce a small final image by discarding build dependencies. Supports optional BUILD_FEATURES for additional features, with cached compilation in builder stage.

add docker-compose.yml for LDK Server testing

2cb3857

introduces docker-compose.yml with Bitcoin Core, CLN, and LND for Lightning testing. The default profile runs these services; the 'ldk-server' profile adds the LDK server; the 'rabbitmq' profile includes RabbitMQ for events.

moisesPompilio force-pushed the add-docker branch from d573de7 to 2cb3857 Compare November 12, 2025 19:36

moisesPompilio closed this Jan 6, 2026

Conversation

moisesPompilio commented Oct 17, 2025

Uh oh!

ldk-reviews-bot commented Oct 17, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ldk-reviews-bot commented Oct 20, 2025

Uh oh!

ldk-reviews-bot commented Oct 23, 2025

Uh oh!

ldk-reviews-bot commented Oct 25, 2025

Uh oh!

ldk-reviews-bot commented Oct 27, 2025

Uh oh!

ldk-reviews-bot commented Oct 29, 2025

Uh oh!

tnull left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

tnull left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

moisesPompilio commented Nov 12, 2025

Uh oh!

moisesPompilio commented Jan 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ldk-reviews-bot commented Oct 17, 2025 •

edited

Loading